"A development tool for testing all actions on any given object - or one action on all objects - at once to see whether the game's responses are sensible."
Chapter: Basic usage Object Response Tests adds new testing commands ANALYZE and TRY. ANALYZE can be used to execute all available commands on a single object to see whether all the messages make sense. TRY is similar but in 'reverse': it tests one verb with all the objects currently in the location. The syntax is TRY , for example TRY PUSHING. For actions that don't act on a noun, like jumping or waiting, there's an ANALYZE NOUNLESS (or just NOUNLESS) command that runs all such actions. There's also an ANALYZE ALL command for those who are feeling adventurous. It runs all the tests on all the objects currently in the location. It is mainly useful for locations with not that many objects to test. For testing the default library actions, just include the extension in your project and both these commands will become available. Actions related to speaking with persons (saying, telling, asking) are excluded because of the various ways different games handle conversation. Chapter: Removing and adding tests Some games may disable some of the standard library actions. To avoid confusion it might be better to skip testing these actions altogether. When play begins: remove the test burning rule; remove the test pushing to rule. Of course, most games have custom actions that are not defined in the standard library. They can be included in the tests by making testing rules for them and adding those rules in the Table of analyzing actions. They will then be available for both ANALYZE and TRY commands. This is the test swimming in rule: announce tests for "swimming in [the noun]"; try the test-actor swimming in the noun. This is the test kicking rule: announce tests for "kicking [the noun]"; try the test-actor kicking the noun. Table of analyzing actions (continued)
topic testing rule
"swimming in" test swimming in rule
"kicking" test kicking rule
For nounless commands the procedure is the same but the table is called "Table of nounless analyzing actions". Chapter: Changing the actor It is possible to run the tests as someone other than the player character. The test-actor variable holds the person who will be the actor in the tests. This can be changed during the game with the command ACTOR IS; for example ACTOR IS BOB. If the test-actor is not the player character any failed actions (that would usually give the "Bob is unable to do that" response) will not print anything at all. Also, the tests will not abide by the persuasion rules. In other words, if you run the tests as Bob, he will respond as if the game's source code read "try Bob shaving the yak", not as if the player had commanded BOB, SHAVE YAK which is by default blocked by the standard library ("Bob has better things to do."). Note that the test-actor variable is set when the play begins. If the game changes the player character, the test-actor variable doesn't change automatically (that is, if you change the player character mid-game, the tests will be run as the original player character if not instructed otherwise). Chapter: A note on releasing The extension automatically disables itself in release versions. Any abovementioned modifications to its behavior should therefore be written in a section that has "Not for release" in the title (see chapter 2.9 "Material not for release" in the I7 manual) to avoid errors in compiling the final product. Chapter: Version history Section: Version 7 (2015-12-31) - updated to work with release 6M62 of Inform. - renamed the 'set testing actor' rule to 'set default testing actor' for clarity. Section: Version 6 (2014-04-30) - updated to work with the new release of Inform 7. - added the 'analyze nounless' action. Section: Version 5 (2013-10-26) - added a way to disable tests without using the deprecated procedural rules. - changed deprecated "change" phrases to "now". - removed a duplicate test attacking rule from the test set. - renamed the test clothing rule to test wearing rule. Older versions of I7 choked on the word "wearing" in the rule but it seems to work in the latest. Section: Version 4 (2010-06-14) - changed 'say test announcements for' to 'announce tests for' so that the extension would be compatibile with Inform build 6E59. Section: Version 3 (2009-09-23) - changed the hardcoded "[italic type]examining [the noun]: [roman type]" to a more flexible 'say test announcements for' phrase. - changed the extension so that the table of analyzing actions is not for debug builds only, so that you can have continuations of that table in the game code and you don't have to delete them or have them in one "not for release"-chapter when a release version is compiled. Section: Version 2 (2008-12-23) - added the command TRY for testing a single verb with all items in the location (thanks to Taleslinger for the idea). - added the command ANALYZE ALL for running all tests on every single item in the location (thanks to Emily Short for the inspiration). - added the possibility to change the actor for the tests. - changed the analyzing action's name to object-analyzing to avoid collisions with other code. It's likely that people might have an action called "analyzing" in their work. - added a not-for-release chapter heading to example B, just because that's what's recommended in the documentation (thanks to the person in ifMUD whose name I didn't write down and have blissfully forgotten). Section: Version 1 (2008-11-18) - initial release Example: * Camp Fire - An example of basic use of the extension
test meCamp Fire
An Interactive Fiction
Release 1 / Serial number 220517 / Inform 7 v10.1.0 / D
Camp
You can see a bonfire and Alice here.
>test me
(Testing.)
>[1] analyze bonfire
examining the bonfire:
The bonfire is blazing hot.
looking under the bonfire:
You find nothing of interest.
searching the bonfire:
You find nothing of interest.
listening to the bonfire:
You hear nothing unexpected.
smelling the bonfire:
You smell nothing unexpected.
attacking the bonfire:
Violence isn't the answer to this one.
buying the bonfire:
Nothing is on sale.
climbing the bonfire:
Little is to be achieved by that.
pulling the bonfire:
It is fixed in place.
pushing the bonfire:
It is fixed in place.
turning the bonfire:
It is fixed in place.
(no exits; can't test pushing to.)
opening the bonfire:
It isn't something you can open.
entering the bonfire:
That's not something you can enter.
getting off the bonfire:
But you aren't on the bonfire at the moment.
closing the bonfire:
It isn't something you can close.
taking the bonfire:
That's fixed in place.
switching on the bonfire:
It isn't something you can switch.
switching off the bonfire:
It isn't something you can switch.
wearing the bonfire:
(first taking the bonfire)
That's fixed in place.
taking off the bonfire:
You aren't wearing the bonfire.
touching the bonfire:
Ow! You almost burn your fingers.
rubbing the bonfire:
You rub the bonfire.
waving the bonfire:
But you aren't holding that.
squeezing the bonfire:
You achieve nothing by this.
burning the bonfire:
This dangerous act would achieve little.
cutting the bonfire:
Cutting it up would achieve little.
tying the bonfire to Alice:
You would achieve nothing by this.
swinging the bonfire:
There's nothing sensible to swing here.
tasting the bonfire:
You taste nothing unexpected.
drinking the bonfire:
There's nothing suitable to drink here.
eating the bonfire:
That's plainly inedible.
dropping the bonfire:
The bonfire is already here.
>[2] try touching
touching yourself:
You achieve nothing by this.
touching the bonfire:
Ow! You almost burn your fingers.
touching Alice:
Alice might not like that.
>[3] analyze nounless
taking inventory:
You are carrying nothing.
jumping:
You jump on the spot.
thinking:
What a good idea.
waiting:
Time passes.
sleeping:
You aren't feeling especially drowsy.
waking up:
The dreadful truth is, this is not a dream.
waving hands:
You wave.
saying yes:
That was a rhetorical question.
saying no:
That was a rhetorical question.
nounless listening:
You hear nothing unexpected.
nounless smelling:
You smell nothing unexpected.
>[4] actor is alice
Object Response Tests now uses Alice as the actor.
>[5] analyze bonfire
examining the bonfire:
Alice looks closely at the bonfire.
looking under the bonfire:
Alice looks under the bonfire.
searching the bonfire:
listening to the bonfire:
Alice listens.
smelling the bonfire:
Alice sniffs.
attacking the bonfire:
buying the bonfire:
climbing the bonfire:
pulling the bonfire:
pushing the bonfire:
turning the bonfire:
(no exits; can't test pushing to.)
opening the bonfire:
entering the bonfire:
getting off the bonfire:
closing the bonfire:
taking the bonfire:
switching on the bonfire:
switching off the bonfire:
wearing the bonfire:
(Alice first taking the bonfire)
taking off the bonfire:
touching the bonfire:
Alice touches the bonfire.
rubbing the bonfire:
Alice rubs the bonfire.
waving the bonfire:
squeezing the bonfire:
Alice squeezes the bonfire.
burning the bonfire:
cutting the bonfire:
tying the bonfire to Alice:
swinging the bonfire:
tasting the bonfire:
Alice tastes the bonfire.
drinking the bonfire:
eating the bonfire:
dropping the bonfire:
"Camp Fire" Include Object Response Tests by Juhana Leinonen. The Camp is a room. The bonfire is in the Camp. It is fixed in place. The description is "The bonfire is blazing hot." Alice is a woman in the Camp. Instead of touching the bonfire: say "Ow! You almost burn your fingers." Test me with "analyze bonfire/try touching/analyze nounless/actor is Alice/analyze bonfire".
When we run the test, we notice that at least the response to "taste bonfire" should be changed to something more appropriate. Example: ** Porcelain - Skipping tests that have destructive side effects Ignoring a verb in certain cases involves removing the existing rules and writing new ones that take special cases into account.
test mePorcelain
An Interactive Fiction
Release 1 / Serial number 220517 / Inform 7 v10.1.0 / D
Porcelain shop
You can see a Ming dynasty vase here.
>test me
(Testing.)
>[1] analyze vase
examining the Ming dynasty vase:
It looks very delicate and fragile.
looking under the Ming dynasty vase:
You find nothing of interest.
searching the Ming dynasty vase:
You find nothing of interest.
listening to the Ming dynasty vase:
You hear nothing unexpected.
smelling the Ming dynasty vase:
You smell nothing unexpected.
attacking the Ming dynasty vase:
Violence isn't the answer to this one.
buying the Ming dynasty vase:
Nothing is on sale.
climbing the Ming dynasty vase:
Little is to be achieved by that.
pulling the Ming dynasty vase:
Nothing obvious happens.
turning the Ming dynasty vase:
Nothing obvious happens.
(no exits; can't test pushing to.)
opening the Ming dynasty vase:
It isn't something you can open.
entering the Ming dynasty vase:
That's not something you can enter.
getting off the Ming dynasty vase:
But you aren't on the Ming dynasty vase at the moment.
closing the Ming dynasty vase:
It isn't something you can close.
taking the Ming dynasty vase:
You're afraid that you might drop it.
switching on the Ming dynasty vase:
It isn't something you can switch.
switching off the Ming dynasty vase:
It isn't something you can switch.
wearing the Ming dynasty vase:
(first taking the Ming dynasty vase)
You're afraid that you might drop it.
taking off the Ming dynasty vase:
You aren't wearing the Ming dynasty vase.
rubbing the Ming dynasty vase:
You rub the Ming dynasty vase.
waving the Ming dynasty vase:
But you aren't holding that.
squeezing the Ming dynasty vase:
You achieve nothing by this.
burning the Ming dynasty vase:
This dangerous act would achieve little.
cutting the Ming dynasty vase:
Cutting it up would achieve little.
tying the Ming dynasty vase to yourself:
You would achieve nothing by this.
swinging the Ming dynasty vase:
There's nothing sensible to swing here.
tasting the Ming dynasty vase:
You taste nothing unexpected.
drinking the Ming dynasty vase:
There's nothing suitable to drink here.
eating the Ming dynasty vase:
That's plainly inedible.
dropping the Ming dynasty vase:
The Ming dynasty vase is already here.
>[2] push vase
Whoops! The vase falls off its pedestal and shatters into thousand pieces.
"Porcelain" Include Object Response Tests by Juhana Leinonen. The Porcelain shop is a room. The Ming dynasty vase is in the porcelain shop. The description is "It looks very delicate and fragile." Instead of taking the Ming dynasty vase: say "You're afraid that you might drop it." After pushing or touching the Ming dynasty vase: say "Whoops! The vase falls off its pedestal and shatters into thousand pieces."; remove the Ming dynasty vase from play. Chapter Tests - Not for release When play begins: remove the test pushing rule; remove the test touching rule. This is the test pushing non-fragile things in rule: if the noun is not the Ming dynasty vase: announce tests for "pushing [the noun]"; try pushing the noun. This is the test touching non-fragile things in rule: if the noun is not the Ming dynasty vase: announce tests for "touching [the noun]"; try touching the noun. Table of analyzing actions (continued)
topictesting rule test pushing rule test touching rule
Test me with "analyze vase/push vase".
Version 7 of Object Response Tests by Juhana Leinonen begins here. "A development tool for testing all actions on any given object - or one action on all objects - at once to see whether the game's responses are sensible." Book 1 - Testing actor The test-actor is a person that varies. This is the set default testing actor rule: now the test-actor is the player. The set default testing actor rule is listed last in the when play begins rulebook. Book 2 - Testing rules To remove (test-rule - a rule): repeat through the Table of analyzing actions: if the testing rule entry is test-rule: blank out the whole row; repeat through the Table of nounless analyzing actions: if the testing rule entry is test-rule: blank out the whole row; To announce tests for (_txt - indexed text): say "[italic type][_txt]:[roman type]". This is the test taking rule: announce tests for "taking [the noun]"; try the test-actor taking the noun. This is the test eating rule: announce tests for "eating [the noun]"; try the test-actor eating the noun. This is the test dropping rule: announce tests for "dropping [the noun]"; try the test-actor dropping the noun. This is the test entering rule: announce tests for "entering [the noun]"; try the test-actor entering the noun. This is the test getting off rule: announce tests for "getting off [the noun]"; try the test-actor getting off the noun. This is the test examining rule: announce tests for "examining [the noun]"; try the test-actor examining the noun. This is the test looking under rule: announce tests for "looking under [the noun]"; try the test-actor looking under the noun. This is the test searching rule: announce tests for "searching [the noun]"; try the test-actor searching the noun. This is the test switching on rule: announce tests for "switching on [the noun]"; try the test-actor switching on the noun. This is the test switching off rule: announce tests for "switching off [the noun]"; try the test-actor switching off the noun. This is the test opening rule: announce tests for "opening [the noun]"; try the test-actor opening the noun. This is the test closing rule: announce tests for "closing [the noun]"; try the test-actor closing the noun. This is the test wearing rule: announce tests for "wearing [the noun]"; try the test-actor wearing the noun. This is the test taking off rule: announce tests for "taking off [the noun]"; try the test-actor taking off the noun. This is the test giving to rule: if the noun is a person: if the test-actor is not carrying something: say italic type; say "(no inventory items; can't test giving to.)" (A); say roman type; say line break; rule succeeds; let give-object be a random thing carried by the test-actor; announce tests for "giving [the give-object] to [the noun]"; try the test-actor giving the give-object to the noun; rule succeeds; if the test-actor is not carrying the noun: rule succeeds; unless the test-actor can see a person who is not the test-actor: say italic type; say "(no other people in the location; can't test giving to.)" (B); say roman type; say line break; rule succeeds; let give-target be a random visible person who is not the test-actor; announce tests for "giving [the noun] to [the give-target]"; try the test-actor giving the noun to the give-target. This is the test showing to rule: if the noun is a person: if the test-actor is not carrying something: say italic type; say "(no inventory items; can't test showing to.)" (A); say roman type; say line break; rule succeeds; let show-object be a random thing carried by the test-actor; announce tests for "showing [the show-object] to [the noun]"; try the test-actor showing the show-object to the noun; rule succeeds; if the test-actor is not carrying the noun: rule succeeds; unless the test-actor can see a person who is not the test-actor: say italic type; say "(no other people in the location; can't test showing to.)" (B); say roman type; say line break; rule succeeds; let show-target be a random visible person who is not the test-actor in the location of the test-actor; announce tests for "showing [the noun] to [the show-target]"; try the test-actor showing the noun to the show-target. This is the test throwing at rule: if the noun is a person: if the test-actor is not carrying something: say italic type; say "(no inventory items; can't test throwing at.)" (A); say roman type; say line break; rule succeeds; let throw-object be a random thing carried by the test-actor; announce tests for "throwing [the throw-object] at [the noun]"; try the test-actor throwing the throw-object at the noun; rule succeeds; if the test-actor is not carrying the noun: rule succeeds; unless the test-actor can see a person who is not the test-actor: say italic type; say "(no other people in the location; can't test throwing at.)" (B); say roman type; say line break; rule succeeds; let throw-target be a random visible person who is not the test-actor in the location of the test-actor; announce tests for "throwing [the noun] at [the throw-target]"; try the test-actor throwing the noun at the throw-target. This is the test waking rule: if the noun is not a person: rule succeeds; announce tests for "waking [the noun]"; try the test-actor waking the noun. This is the test attacking rule: announce tests for "attacking [the noun]"; try the test-actor attacking the noun. This is the test kissing rule: if the noun is not a person: rule succeeds; announce tests for "kissing [the noun]"; try the test-actor kissing the noun. This is the test touching rule: announce tests for "touching [the noun]"; try the test-actor touching the noun. This is the test waving rule: announce tests for "waving [the noun]"; try the test-actor waving the noun. This is the test pulling rule: announce tests for "pulling [the noun]"; try the test-actor pulling the noun. This is the test pushing rule: announce tests for "pushing [the noun]"; try the test-actor pushing the noun. This is the test turning rule: announce tests for "turning [the noun]"; try the test-actor turning the noun. Definition: a direction is push-to-possible if the room it from the location of the test-actor is a room. This is the test pushing to rule: let push-direction be a random push-to-possible direction; if the push-direction is nothing: say italic type; say "(no exits; can't test pushing to.)" (A); say roman type; say line break; rule succeeds; announce tests for "pushing [the noun] to [push-direction]"; try the test-actor pushing the noun to push-direction. This is the test squeezing rule: announce tests for "squeezing [the noun]"; try the test-actor squeezing the noun. This is the test burning rule: announce tests for "burning [the noun]"; try the test-actor burning the noun. This is the test smelling rule: announce tests for "smelling [the noun]"; try the test-actor smelling the noun. This is the test listening to rule: announce tests for "listening to [the noun]"; try the test-actor listening to the noun. This is the test tasting rule: announce tests for "tasting [the noun]"; try the test-actor tasting the noun. This is the test cutting rule: announce tests for "cutting [the noun]"; try the test-actor cutting the noun. This is the test tying to rule: let tie-target be a random visible thing that is not the noun in the location of the test-actor; announce tests for "tying [the noun] to [the tie-target]"; try the test-actor tying the noun to the tie-target; This is the test drinking rule: announce tests for "drinking [the noun]"; try the test-actor drinking the noun. This is the test swinging rule: announce tests for "swinging [the noun]"; try the test-actor swinging the noun. This is the test rubbing rule: announce tests for "rubbing [the noun]"; try the test-actor rubbing the noun. This is the test setting to rule: announce tests for "setting [the noun] to 1"; try the test-actor setting the noun to "1". This is the test buying rule: announce tests for "buying [the noun]"; try the test-actor buying the noun. This is the test climbing rule: announce tests for "climbing [the noun]"; try the test-actor climbing the noun. [Nounless rules] This is the test taking inventory rule: announce tests for "taking inventory"; try the test-actor taking inventory. This is the test jumping rule: announce tests for "jumping"; try the test-actor jumping. This is the test thinking rule: announce tests for "thinking"; try the test-actor thinking. This is the test waiting rule: announce tests for "waiting"; try the test-actor waiting. This is the test sleeping rule: announce tests for "sleeping"; try the test-actor sleeping. This is the test waking up rule: announce tests for "waking up"; try the test-actor waking up. This is the test waving hands rule: announce tests for "waving hands"; try the test-actor waving hands. This is the test saying yes rule: announce tests for "saying yes"; try the test-actor saying yes. This is the test saying no rule: announce tests for "saying no"; try the test-actor saying no. This is the test nounless listening rule: announce tests for "nounless listening"; try the test-actor listening. This is the test nounless smelling rule: announce tests for "nounless smelling"; try the test-actor smelling. Book 3 - Analyzing action Part 1 - Table of analyzing actions Table of analyzing actions
topictesting rule test examining rule test looking under rule test searching rule test listening to rule test smelling rule test attacking rule test buying rule test climbing rule test pulling rule test pushing rule test turning rule test pushing to rule test opening rule test entering rule test getting off rule test closing rule test taking rule test switching on rule test switching off rule test wearing rule test taking off rule test throwing at rule test showing to rule test giving to rule test waking rule test kissing rule test touching rule test rubbing rule test waving rule test squeezing rule test burning rule test cutting rule test tying to rule test swinging rule test tasting rule test drinking rule test eating rule test dropping rule
Table of nounless analyzing actions
topic testing rule "taking inventory" test taking inventory rule "jumping" test jumping rule "thinking" test thinking rule "waiting" test waiting rule "sleeping" test sleeping rule "waking up" test waking up rule "waving hands" test waving hands rule "saying yes" test saying yes rule "saying no" test saying no rule "nounless listening" test nounless listening rule "nounless smelling" test nounless smelling rule
Book 4 - Actions - Not for release Object-analyzing is an action applying to one visible thing. Understand "analyze [something]" as object-analyzing. Understand "analyse [something]" as object-analyzing. Carry out object-analyzing (this is the go through all analyzing rules rule): repeat through the table of analyzing actions: if there is a testing rule entry: follow the testing rule entry. All-encompassing analyzing is an action applying to nothing. Carry out all-encompassing analyzing (this is the analyze everything in the location rule): repeat with x running through things enclosed by the location of the test-actor: if the test-actor can see x: try object-analyzing x. Understand "analyze all" as all-encompassing analyzing. Nounless analyzing is an action applying to nothing. Understand "analyze nounless" and "analyse nounless" and "nounless" as nounless analyzing. Carry out nounless analyzing (this is the go through all nounless analyzing rules rule): repeat through the table of nounless analyzing actions: if there is a testing rule entry: follow the testing rule entry. Test-verb-trying is an action applying to one topic. Understand "try [text]" as test-verb-trying. Check test-verb-trying (this is the unknown verb test label rule): if the topic understood is not a topic listed in the Table of analyzing actions: say "Unknown verb test." (A) instead. Carry out test-verb-trying (this is the repeat an action with all objects rule): if the topic understood is a topic listed in the Table of analyzing actions: repeat with x running through things enclosed by the location of the test-actor: if the test-actor can see x: now the noun is x; follow the testing rule entry. Changing the test actor is an action out of world applying to one visible thing. Understand "actor is [any person]" as changing the test actor. Carry out changing the test actor (this is the change testing actor rule): now the test-actor is the noun; say "Object Response Tests now uses [the noun] as the actor." (A). Object Response Tests ends here.
Include Object Response Tests by Juhana Leinonen.
Copy "Camp Fire" to clipboard